home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / ARCHIVE / AC150A.ZIP;1 / AC.DOC < prev    next >
Encoding:
Text File  |  1991-12-01  |  20.3 KB  |  594 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                      ≤≤≤≤±              ≤≤≤≤≤≤
  25.                     ≤±   ≤±    V1.50a  ≤≤±   ≤≤±
  26.                    ≤±     ≤±          ≤≤±
  27.                   ≤≤±     ≤≤±         ≤≤±
  28.                   ≤≤≤≤≤≤≤≤≤≤±         ≤≤±
  29.                   ≤±       ≤±          ≤≤±   ≤≤±
  30.                   ≤±       ≤±rchive     ≤≤≤≤≤≤±onverter
  31.                            
  32.                
  33.                           Donald M. Langhorne
  34.                         South 5241 Columbia Ave.
  35.                            Hamburg, NY 14075
  36.  
  37.  
  38.                          Regisration only $10
  39.                                    
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.                                      -i-
  48.  
  49.  
  50.                                     Contents
  51.                                     --------
  52.  
  53.  
  54.                       Introduction---------------------- 1
  55.                       Special Features------------------ 1
  56.                       Installation---------------------- 1
  57.                       Archive programs------------------ 2
  58.                       Usage----------------------------- 3
  59.                       Commands-------------------------- 4
  60.                       Options--------------------------- 5
  61.                       Examples-------------------------- 5
  62.                       Using ACSETUP--------------------- 6
  63.                       Limitations----------------------- 7
  64.                       History of Revisions-------------- 8
  65.                       Disclaimer------------------------ 10
  66.                       Registration---------------------- 10
  67.  
  68.  
  69.  
  70.                                       -1-
  71.  
  72.  
  73.  
  74. INTRODUCTION:
  75. =============
  76.  
  77.         AC is a command line archive converter.  Unlike full blown menu
  78.      driven programs, AC is completely command line oriented.
  79.      It is not necessary to have any knowledge of the archive
  80.      program switches, unless you plan to modify the configuration file.
  81.  
  82.         AC supports the most popular archive programs in circulation.
  83.      By customizing the AC.CFG file that is now an integral part of
  84.      AC, it is possible to use almost any archive program.  AC allows
  85.      for easy conversion between any two archive types specified.
  86.      It accepts both wild card specifications and multiple file
  87.      specifications on the command line.
  88.  
  89.  
  90. SPECIAL FEATURES:
  91. =================
  92.  
  93.       -AC has the ability to report conversion to a log file
  94.       -AC works in conjunction with a configuration file AC.CFG.  This allows
  95.        for customization
  96.       -AC supports recursive archives.  To convert an archive recursively
  97.        the archive being converted to MUST support recursion.
  98.       -AC has a /c switch to prevent suppresion any ouput during
  99.        execution of the archivers/dearchivers
  100.       -AC has a /v switch to scan the archives for viruses during conversion
  101.       -AC supports creation/extraction of SFX files created by many of
  102.        the archivers.   
  103.       -AC will prompt for a new file name if it is about to overwrite an
  104.        archive file.    
  105.       -AC accepts wildcard specifications on the command line.
  106.       -AC allows an unlimited number of files and or file specs. on the
  107.        command line.  Each file must be separated by a space.                
  108.       -If the file you want to convert is unique(no other file by that name
  109.       exists in the current directory) you do not need to specify the 
  110.       extension, AC will find it for you.
  111.  
  112.  
  113.  
  114. Installation:
  115. =============
  116.  
  117.         Installation can be completed by following these simple steps:
  118.  
  119.         1)  Copy the files AC.EXE and AC.CFG to a directory in your path
  120.  
  121.         2)  Wherever you place AC.EXE, AC.CFG and ACSETUP MUST be in the SAME
  122.             location for AC to operate.
  123.  
  124.         3)  Check the file AC.CFG to make sure that the archivers match
  125.             the ones you use, and if necessary modify it to suit your
  126.             system(See the section modifying AC.CFG for more help)
  127.  
  128.  
  129.         That's It!! Enjoy.
  130.  
  131.  
  132.  
  133.                                       -2-
  134.  
  135. Archive Programs:
  136.  
  137.         The following is a list of all known archivers that I was able
  138.         to integrate into AC along with the versions I have tested
  139.  
  140.         -AC will search your path for the following archive programs:
  141.  
  142.  
  143. Type:          Files Supported           Vendor   Versions(tested & supported)
  144. =============================================================================
  145.  
  146. ARC programs:
  147.                pkarc.exe & pkxarc.exe   {PKWARE, Inc.}        3.61
  148.                pkpak.exe & pkunpak.exe  {PKWARE, Inc.}        3.61
  149.                arc.exe                  {Sea, Inc.}           6.02
  150.  
  151. ARJ programs:
  152.                arj.exe                  {Robert Jung}         2.00-2.21
  153.  
  154. LZH programs:
  155.                lha.exe                  {Haruyasu Yoshizaki}  2.11-13
  156.                lharc.exe                {Haruyasu Yoshizaki}  1.13c
  157.  
  158. ZIP programs:
  159.                pkzip.exe & pkunzip.exe   {PKWARE, Inc.}       1.10
  160.  
  161. DWC programs:
  162.                dwc.exe                   {Dean W. Cooper}     A5.01
  163.  
  164. HYP programs:                            (P. Sawatzki K.P. Nischke}
  165.                hyper.exe                                      2.5
  166.  
  167. ZOO programs:
  168.                zoo.exe                   {Rahul Dhesi}        2.01-2.10
  169.  
  170. MD  programs:
  171.                mdcd.exe                  {Mike Davenport}     1.00
  172.  
  173. PAK programs:
  174.                pak.exe                   {NOGATE Consulting}  2.51
  175.  
  176. LZS programs:                     {K.MIKI H.OKUMURA K.MASUYAMA}
  177.                larc.exe &larc7e.ovr                           3.33
  178.  
  179.  
  180.  
  181.                                      -3-
  182.  
  183.  
  184.  
  185. USAGE:
  186.      The syntax is as simple and forgiving as possible.  All that is
  187.      necessary to convert an archive is to follow these simple rules:
  188.  
  189.         1) make sure you are in the current directory of the archive
  190.            you want to convert
  191.  
  192.         2) Determine what you want to convert to and find out the switch you
  193.            need by running AC without any switches
  194.  
  195.         3) Be sure the archive you want to convert has an apprropriate
  196.            extension.  IE ZIP files should have a .zip extension.  This
  197.            is how AC determines what archive extractor to use
  198.  
  199.         4) Enter the command 'AC /<switch>[option] Archive file'
  200.                 There are no spaces between switches and options
  201.  
  202.  
  203.  
  204.                                      -4-
  205. COMMANDS:
  206. =========
  207.  
  208.      /K (Keep original archive)
  209.        This switch causes AC to process the archive normally, but will 
  210.        not delete the original archive.
  211.  
  212.      /C (Show Output to Console)
  213.        This switch causes all output to be shown on the screen, 
  214.        instead of the default which suppresses output.
  215.  
  216.      /V (Scan for viruses)
  217.        This switch causes AC to scan the archive for viruses using 
  218.        Mcafee's SCAN.  If used in conjunction with the /R switch
  219.        AC will scan the archive recursively.
  220.  
  221.      /W (Write output to log file)
  222.           When using this switch AC will report file sizes and file
  223.           names to a log file called AC.LOG, which is located in the
  224.           same location as AC.EXE, if AC.LOG does not exist then AC will
  225.           create it.
  226.  
  227.      /A (Convert to ARC file)
  228.        This switch converts an archive to a corresponding ARC file.
  229.      
  230.      /D (Convert to DWC file)
  231.        This switch converts an archive to a corresponding DWC file.
  232.  
  233.      /H (Convert to HYP file)
  234.        This switch converts an archive to a corresponding HYP file.
  235.  
  236.      /J (Convert to ARJ file)
  237.        This switch converts an archive to a corresponding ARJ file.
  238.      
  239.      /L (Convert to LZH file)
  240.        This switch converts an archive to a corresponding LZH file.
  241.  
  242.      /O (Convert to ZOO file)
  243.        This switch converts an archive to a corresponding ZOO file.
  244.      
  245.      /P (Convert to PAK file)
  246.        This switch converts an archive to a corresponding PAK file.
  247.  
  248.      /M (convert to MD file)
  249.        This switch converts an archive to a corresponding MD file.
  250.      
  251.      /S (Convert to LZS files)
  252.        This switch converts an archive to a corresponding LZS file
  253.  
  254.      /Z (convert to ZIP files)
  255.        This switch converts an archive to a corresponding ZIP file
  256.  
  257.  
  258.  
  259.                                       -5-
  260.  
  261.  
  262.  
  263.  
  264. OPTIONS:
  265. ========
  266.      The options are used in conjunction with the archive switches, they
  267.      have no effect when used on their own.
  268.           
  269.      e  Create SFX file
  270.      
  271.      x  Use extra compression.  This option has been removed due to the
  272.         fact that it can be easily added to the AC.CFG as the default.
  273.      
  274.      t  Set date to latest member.  This option will set the date
  275.         of the resulting archive to equal the newest member of
  276.         the archive file.
  277.      
  278.      r  Convert archives recursively.  If any directories are stored
  279.         in archive that is to be converted, it's directory structure
  280.         will be retained.
  281.  
  282.         NOTE: Simply add the option after the switch without spaces or
  283.           any other characters between the two.  Multiple switches
  284.           may be strung together.
  285.  
  286.  
  287. EXAMPLES:
  288. =========
  289.  
  290.           1.)  AC file1.arc
  291.                  this converts the file 'file1.arc' to a zip 
  292.                  file with the name 'file1.zip'
  293.  
  294.           2.)  AC file1
  295.                  this searches the current directory for a file 
  296.                  matching 'file1.*'.  If no file is found or the file does 
  297.                  not have a valid extension, then no action is taken.
  298.      
  299.           3.)  AC *.ARJ  
  300.                  this searches the current directory for all files
  301.                  with .ARJ extensions and convert each file in turn, 
  302.                  the name of each will remain the same, except the extension 
  303.                  will become .ZIP
  304.  
  305.           4.)  AC /K /L file.zoo  
  306.                   This converts the file 'file.zoo' to 
  307.                   'file.lzh' and keeps the original archive intact.
  308.  
  309.  
  310.           5.)   AC /jert MYFILE.ZIP
  311.                   This will convert the file MYFILE.ZIP with the following
  312.                   options:
  313.                  --MYFILE.ZIP will be converted to an ARJ file.
  314.                  --MYFILE.ZIP will convert files recursively
  315.                  --MYFILE.EXE will be created since e option spec. 
  316.                  --MYFILE.EXE will use the date of it's latest member
  317.  
  318.  
  319.  
  320.                                      -6-
  321.  
  322. Using ACSETUP
  323. =======================
  324.  
  325.  
  326.        -ACSETUP is a menu driven program that allows the user to easily
  327.         and quickly configure the AC.CFG program for use with AC.EXE.
  328.         Once AC.CFG is configured it is not necessary to keep ACSETUP
  329.         installed, but any changes that need to be made should be done
  330.         using ACSETUP.
  331.  
  332.        -Assuming ACSETUP is in your path and AC.CFG is in THE SAME
  333.         DIRECTORY as ACSETUP, ACSETUP can be run from any directory.
  334.  
  335.        -When using ACSETUP, use the up and down arrow keys to highlight
  336.         the item you wish to change.  Then hit the enter key to choose
  337.         your choice.  ESC will return you to the previous menu options.
  338.         and if you hit ESC at the main menu, it will exit the program.
  339.  
  340.  
  341.        -Major features of ACSETUP, and some limitations.
  342.  
  343.          1) If you make changes in ACSETUP, you MUST save them by
  344.             selecting the last option on the main menu 'Save
  345.             configuration'  Your changes will not be saved unless this
  346.             is done.
  347.  
  348.          2) All archivers are different, and some require that all the
  349.             switches be separated by spaces, others require NO spaces.
  350.             It is up to the user to be sure to take this into account
  351.             when changing/adding switches.
  352.  
  353.                 Example:
  354.                  to compress an ARJ file with recursion and
  355.                  timestamping from DOS you would normally type
  356.                  something like this:
  357.                                 ARJ a -r -s arjfile.arj
  358.  
  359.                  --The normal switch would be ' a '
  360.                  --The recursive switch would be ' -r '
  361.                  --The timestamp switch would be ' -s '
  362.  
  363.                 When AC runs, it simply adds these lines together, so
  364.                 if there are no spaces entered, the command would become:
  365.                                 ARJ a-r-s arjfile.arj
  366.                 which would cause ARJ to return an error message.
  367.  
  368.          3) Simply hitting return when asked to enter a value will cause
  369.             ACSETUP not to change anything(The original value will be
  370.             retained).  The one exception is when entering the
  371.             registration number, which need only be entered once.
  372.  
  373.          4) The menu choice 'Default toggles' is only applicable to the
  374.             registered version.  While you can enter and make changes
  375.             to these values, they will not be recongized by AC unless
  376.             a valid registration number has been entered.
  377.  
  378.  
  379.  
  380.  
  381.                                 -7-
  382.  
  383. LIMITATIONS:
  384. ============
  385.  
  386.         The following is a compilation of known limitations that I have
  387.         encountered while writing AC, some are in the works(to be added
  388.         in future releases) and others are inherent in the archivers
  389.         that AC uses and would be extremely difficult, if not impossible
  390.         to fix
  391.  
  392.         --At this time it is NOT possible to rename AC.EXE, if it is
  393.           renamed, AC will crash due to how it looks for AC.CFG.  This
  394.           will be addressed in a future release.
  395.  
  396.         --When extracting a SFX archive created by ARJ that has
  397.           sub-directories(Created with recursion) It is NOT possible to
  398.           extract the archive to a single directory, even though
  399.           apparently it is an option with the ARJSFX module.  To avoid
  400.           lost files, be sure to convert to an archive type that
  401.           supports recursion, and also add the 'r' option to enable
  402.           recursion.  If a fix is ever made to ARJ to correct this,  AC
  403.           is already configured to use the switches to support it.
  404.  
  405.         --Do not Add Recursive switch settings to DWC or ZOO, while they
  406.           both support recursion, they both use the full path with the
  407.           drive, and will not work with AC at this time.
  408.  
  409.         --While AC does support the option to scan archives for viruses,
  410.           I have not been able to test this feature properly in a
  411.           real-time situation.  I would appreciate hearing from ANYONE
  412.           who experience a virus detection with AC, and can let me know
  413.           if it executed properly or not.
  414.  
  415.         --While Larc does have the ability to create SFX files, it will
  416.           create a COM file if it is less than 65k and an EXE if greater
  417.           than 65k.  At this time AC does not support SFX files with
  418.           COM extensions.  This will be addressed in a future release.
  419.  
  420.         --DWC uses the environment variable TEMP if it exists to point
  421.           to the directory for it to create temporary files in.  If this
  422.           value is set to a directory that does not exist DWC will not
  423.           function.
  424.  
  425.         --When using 4DOS or NDOS(Norton) AC will NOT convert files properly
  426.           with LHA.  This seems to be a problem with 4dos's handling of
  427.           the NULL device.  It is recommended to use MSDOS 4.0+
  428.  
  429.  
  430.  
  431.                                   -8-
  432.  
  433.  
  434. History
  435. =======
  436. *(NR)==Not Released
  437.  
  438.    Version 1.50a [11-30-91]
  439.    ========================
  440.    -Fixed bug that caused AC not to work properly when it was renamed.
  441.  
  442.    Version 1.50  [11-19-91]
  443.    ========================
  444.    -Changes made to AC and AC.CFG to accomadate ACSETUP.
  445.    -Added ability for renaming AC.EXE to any other name, so long as the
  446.     .CFG file is also renamed to the same name
  447.  
  448.    Version 1.42a [11-14-91](NR)
  449.    ========================
  450.    -Fixed very minor glitch in the logging routine.
  451.  
  452.    Version 1.42  [11-13-91]
  453.    ========================
  454.    -Fixed problems with the log file, output was not lined up making it
  455.     hard to view as the file became larger.  Added size difference to
  456.     log file.
  457.  
  458.    Version 1.41  [11-12-91] (NR)
  459.    ========================
  460.    -Removed the 'x' switch for extra compression.  This option can still
  461.     be used by adding the proper switches to the AC.CFG file.
  462.  
  463.    Version 1.40  [11-05-91]
  464.    ========================
  465.    -Minor modifications to screen output
  466.  
  467.    Version 1.38  [10-17-91] (NR)
  468.    ========================
  469.    -Fixed long standing bug that prevented using file*.* wildcard specs
  470.     on the command line. Could use file.* or file*, but not file*.*.
  471.     fixed.
  472.  
  473.    Version 1.37  [10-15-91]
  474.    ========================
  475.    -More bug fixes, problem with converting to an SFX of type ARJ,
  476.    fixed.
  477.  
  478.    Version 1.36  [10-07-91] (NR)
  479.    ========================
  480.    -Bug Fixes
  481.  
  482.    Version 1.35  [10-06-91] (NR)
  483.    ========================
  484.    -Added logging feature, uses new switch /w.  Will create and/or
  485.     add to AC.LOG the files it has converted and size differences.
  486.  
  487.    Version 1.34  [10-05-91] (NR)
  488.    ========================
  489.    -More bug fixes
  490.  
  491.  
  492.                                 -9-
  493.  
  494.    Version 1.33  [10-04-91] (NR)
  495.    ========================
  496.    -Fixed some leftover bugs and made AC rely more heavily on it's
  497.     config file
  498.  
  499.    Version 1.32  [10-03-91] (NR)
  500.    ========================
  501.    -Added registration requirement for certain defaults to be recognized
  502.     in AC.CFG
  503.  
  504.    Version 1.31  [10-02-91] (NR)
  505.    ========================
  506.    -Added colors to AC
  507.  
  508.    Version 1.3F  [10-02-91] (NR)
  509.    ========================
  510.    -Improved speed with screen writes, particularly the help screen
  511.  
  512.    Version 1.3A-E [09-29-91] (NR)
  513.    =======================
  514.    -Continual refinement of interpreting AC.CFG file
  515.    -AC now depends on the existence of AC.CFG for execution
  516.  
  517.    Version 1.3  [09-21-91] (NR)
  518.    =======================
  519.     -Began conversion of program to separate source files and 
  520.      formed basis for using configuration file
  521.  
  522.    Version 1.2B [09-17-91] (NR)
  523.    =======================
  524.     -Fixed bug that would cause AC to crash if an Archive and exe had
  525.      the same name, but the exe was NOT a SFX file.
  526.  
  527.    Version 1.2A [08-28-91] (NR)
  528.    =======================
  529.     -Fixed minor bug where AC would report it's switch info for each
  530.      archive converted if multiple filespecs were specified.
  531.  
  532.  
  533.    Version 1.2  [08-21-91]
  534.    =======================
  535.         -Removed some final code left over for debuging purposes.
  536.  
  537.  
  538.                                 -10-
  539.  
  540.  
  541. DISCLAIMER:
  542. ===========
  543.  
  544.      I assume no liability or responsibility for any damages that may occur
  545.      from the use or misuse of this program.  A user operates this program 
  546.      without any guarantees as to the accuracy of the information included.  
  547.      All use is at the user's risk.
  548.  
  549.  
  550. A note on registration:
  551. =======================
  552.  
  553.      I am releasing this program as shareware.  Using this program for a
  554.      NON-COMMERCIAL PURPOSE is allowed.  If you find this program of use, 
  555.      a donation of $10 is encouraged.  Use of this program 
  556.      for COMMERCIAL use REQUIRES registration of $10 US per copy.
  557.      Please make payment in US funds to:
  558.  
  559.        Donald M. Langhorne
  560.        South 5241 Columbia Ave.
  561.        Hamburg, NY  14075
  562.  
  563. Thank you for your interest in AC.
  564.  
  565.  
  566. Why register:
  567. =============
  568.  
  569.         Registering this program gives you a license to use AC and enjoy
  570.         free upgrades for the life of the program.  The registered
  571.         version will enable defaults for all options to be set
  572.         either on or off in the CFG file.
  573.         For more information or to register write to the above address.
  574.  
  575. problems or suggestions:
  576. ========================
  577.  
  578.    If you encounter a problem or have any suggestions in reference to this
  579.    program, please send your comments to the above address or to the 
  580.    following boards.  I am interested in you problems/suggestion
  581.    with/for AC.  Please contact me with any questions or problems.  I
  582.    will try to help anyone, registered or not who takes the time to get
  583.    in touch with me as best as I can.
  584.  
  585.  
  586.      BIBMUG:716-695-0583
  587.      Data Express:716-627-3299 (19200-HST) OR 716-627-7420 (2400)
  588.  
  589.      I have a forum that just opened up on the Data Express that is
  590.      dedicated to Q & A about AC, so feel free to drop me a line and
  591.      let me know your suggestions.
  592.  
  593.                 
  594.